Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Handling Error Conditions in a Message Override

GXCleanupOpenConnection

You can use the GXCleanupOpenConnection function to notify QuickDraw GX that it needs to clean up any actions that it took after receiving a GXOpenConnection message from your printing extension or printer driver.

void GXCleanupOpenConnection (void);

DESCRIPTION

You need to call the GXCleanupOpenConnection function if you encounter an error in your override of the GXOpenConnection message and you have already forwarded the message.

When you call GXCleanupOpenConnection, QuickDraw GX sends the GXCleanupOpenConnection message, which allows all of the message handlers to reverse any actions that they took in their overrides of the GXOpenConnection message, such as allocating storage or modifying state information.

SEE ALSO

The GXOpenConnection and GXCleanupOpenConnection messages are described in the chapter "Printing Messages."

An example of using the GXCleanupOpenConnection function is shown in Listing 5-4 on page 5-11.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help